The Remote Data Stores Page

This element, shown in the figure below, is used to display the last date that the User listing was refreshed.

This element consists of two components, the Refreshed Link and the Date Set Link, discussed in the following two sections.

This component, shown in the figure below, is used to refresh the organization's Remote Data Stores list.

To refresh the Remote Data Stores listing, simply click the link shown in the figure above.

This component, shown in the figure below, is primarily used to display the date and time that the Remote Data Stores list was last updated.

Clicking the Date/Time link will display the Date/Time Link menu, shown in the figure below.

This menu displays the amount of time between the current time and the last time the Users list was updated, and allows you to:

• Copy the date and time of last Linked Organization list refresh in ISO-8601 format.

• Copy the date and time of last Linked Organization list refresh in UNIX time format.

• Change the default time preferences for your account. Clicking the Change time preferences . . . link will take you to the My Account page of the Administration group. Refer to the Orbital My Account Page topic for more information on setting your account's default Time Options.

The Add Remote Data Store link, shown below, is used to add a new remote data store to the organization's usable datastore list.

Clicking this link will display the Add Remote Data Store dialog, shown in the figure below.

This popup window consists of the following six user interface elements:

The Destination radio button set is where you will define the remote data store service that will be used for the remote data store definition. Orbital integrates directly with Amazon S3™, Azure™, and Splunk™. Orbital also can use any custom data store that can receive an HTTP POST, authenticate, and be verified as described in the Under The Hood section of the Remote Data Stores topic.

The default value for this button set is Default, which allows you to define your own remote data store service.

Defining this value is required.

This field is used to define the name of the new data store. This name must be unique in the organization. Naming a new remote data store is required.

A unique name for the remote data store is required.

This field is used to define the uniform resource locator (URL) of the remote data store service. This can be Amazon S3, Asure, or Splunk, as well as a custom remote data store service.

Defining the URL to the remote data store's service is required.

This field accepts the authentication token that you will obtain from the remote data store provider you are connecting to.

Defining the remote data store's token is optional. You only need to define it if the service requires it.

This field accepts the character string that is provided as the fingerprint for those remote data stores that provide a self-signed certificate.

Refer to the Obtainting RDS Fingerprints section in the Setting Up Remote Data Stores topic.

Defining the remote data store's fingerprint is optional. You only need to define it if the service requires it.

This button pair is used to define the format that the results of the query or script will take when sent to the remote data store being defined.

The valid values are compact and expanded. An example of a compact result format can be found in the Compact Formatted Result section of the Result Notifications topic. Also, an example of an expanded result format can be found in the Expanded Formatted Result section of the Result Notifications topic.

The default value for this button set is Compact.

Defining the format of the query or script results is required; however, you can leave the definition to the default value.

It is important to understand that the data input fields of this popup will change depending on which remote data store Desalination you have selected to create.

• If you are defining a Splunk remote data store, you will need to define:

• HEC URL

• HEC Token

• HEC Fingerprint

• If you are defining an Amazon remote data store, you need to define:

• Bucket

• Region

• Access Key

• Secret Key

• If you are defining an Azure remote data store, you will need to define:

• Container URL

• Container Name

• SAS Token

The Remote Data Store Docs link, shown in the figure below, is used to open the Create a Remote Data Store API documentation.

The Remote Data Store List pane, shown in the figure below, is the area of the Remote Data Store page that displays all of the remote data stores that have been defined for your organization.

This listing displays the following information in the following eight columns:

This column displays the assigned name of the remote data store.

Beside the name of the remote data store is the Edit Remote Data Store icon (). If you click on the icon, you will be presented with the Edit Remote Data Store dialog, shown in the figure below.

This dialog is the same as the Add Remote Data Store dialog; however, the remote data store definitions will populate the different screen elements. Additionally, you will also have the ability of deleting the currently listed data store.

This column displays the Orbital-assigned ID number of the remote data store record. If you hover over a record's ID number, the Copy icon () is displayed. Clicking the icon will copy the ID number to the clipboard.

This column displays the date and time that the remote data store's Orbital record was created. Clicking the date and time value will display the record creation information popup, shown in the figure below.

This column displays the name of the person or organization that created the remote data store definition.

This column displays whether or not the remote data store host has authenticated the connection request.

If the remote data store host is able to authenticate the request, the status message Authenticated will be displayed in the column. If; however, the remote data store host cannot authenticate the request or  if the remote data store host does not exist, an error message will be listed in this column.